home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / viewers / pcxut10 / pcxutils.doc < prev    next >
Text File  |  1993-10-11  |  3KB  |  79 lines
  1. PCX transformations from command-line
  2.  
  3. PCXUTILS offers a number of simple-minded transformations on monochrome and 
  4. 16-color PCX files:
  5. -  conversion to monochrome (without dithering)
  6. -  inverting colors
  7. -  solving problems
  8.  
  9.  
  10. WHEN TO USE PCXUTILS
  11. --------------------
  12. -  when Graphics Workshop chokes on a large bitmap
  13. -  when your graphics program insists on storing a monochrome picture as a
  14.    color bitmap (e.g. WP Presentations)
  15. -  when your wordprocessor can't make sense of a PCX file
  16. -  when you want to automate simple conversions (see also tips at end of file)
  17.  
  18.  
  19. KNOWN PROBLEMS WITH PCX FILES
  20. -----------------------------
  21. -  WordPerfect sometimes scrambles a monochrome bitmap, especially one
  22.    generated by MS PaintBrush.
  23. -  The emTeX DVI drivers sometimes render Harvard Graphics bitmaps
  24.    as a solid black box.
  25. -  Some versions of Ventura seem to require a round number (in terms of pixels)
  26.    for the image width.
  27.  
  28.  
  29. SYNTAX
  30. ------
  31.    PCXUTILS [option] filename
  32.  
  33. [option] can be:
  34.    /i   invert
  35.    /m   color to monochrome: every non-white color becomes black;
  36.            Successive /i /m /i transformations would
  37.            map every non-black color to white.
  38.            The current version doesn't offer dithering.
  39.    /r   round image size up to even n. of bytes per line
  40.    /p+  standardize palette by interpreting existing palette; equivalent to /p
  41.    /p-  standardize palette and ignore existing palette
  42. Only the first option is honored.
  43.  
  44.  
  45. NOTES
  46. -----
  47. -  Irrespective of the option entered, the number of bytes per line is rounded 
  48.    up to an even number; this is required by the PCX standard. This has no
  49.    effect on image width.
  50. -  If applicable, the number of bytes per line is reduced to the smallest 
  51.    possible number. This should solve problems with e.g. monochrome MS 
  52.    Paintbrush files imported into WordPerfect.
  53. -  The /p option should make Harvard Graphics PCX files acceptable to e.g. the 
  54.    emTeX DVI-drivers.
  55. -  Color bitmaps may increase in size because data are compressed per line
  56.    per bitplane, although the PCX standard allows compression of all bitplanes
  57.    of one line at one go.
  58.  
  59. TIPS
  60. ----
  61. -  If you want to convert a bitmap to monochrome, and you want to map every 
  62.    non-black color to white, you can accomplish this by successive /i /m /i
  63.    transformations:
  64.       COPY BITFILE.PCX *.SAV (just in case...)
  65.       PCXUTILS /I BITFILE
  66.       PCXUTILS /M BITFILE
  67.       PCXUTILS /I BITFILE
  68. -  In batch files, you can suppress a request for user input by eg.
  69.       ECHO Y | PCXUTILS /I BITFILE
  70. -  You can also suppress screen output:
  71.       ECHO Y | PCXUTILS /I BITFILE >NUL
  72.  
  73. This program is donated to the Public Domain.
  74.  
  75. August 8 1993
  76.  
  77. Siep Kroonenberg
  78. Email: N.S.Kroonenberg@eco.rug.nl
  79.